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[57] ABSTRACT 

Methods and apparatus for the concurrent display of two or 
more property pages of a Graphical User Interface (GUI) are 
disclosed. A user can select a property page displayed by a 
first property sheet system and create a second property 
sheet system that displays the selected property page at 
second, user selected display position. Alternatively, the user 
can place, or dock, the selected property page into an 
existing property sheet system for inclusion therein and 
display thereby. The first property sheet system displays, at 
a first display position, any of the property pages remaining 
therein. Typically, the selected property page is removed 
from the first property sheet system and the first property 
sheet system is destroyed if it contains no other property 
pages. The invention allows a user of a GUI to concurrently 
display and interact with multiple property pages of multiple 
property sheet systems for optimizing the exchange of 
information with the GUI. 

33 Claims, 7 Drawing Sheets 
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DYNAMIC PROPERTY SHEET SYSTEM 

This application claims priority under 35 U.S.C. 119(e) 
to co-pending U.S. provisional application Sen No. 60/019, 
782, filed Jun. 14, 1996 now pending, the contents of which 
are hereby incorporated by reference. 

A portion of the disclosure of this patent document 
contains material which is subject to copyright protection. 
The owner has no objection to the facsimile reproduction by 
anyone of the patent document or the patent disclosure, as it 
appears in the Patent and Trademark Office patent file or 
records, but otherwise reserves all copyright rights whatso- 
ever. 

FIELD OF THE INVENTION 

The present invention relates to graphical user interfaces, 
and particularly to property sheet systems having property 
pages viewable on a graphical user interface. 

BACKGROUND 

A graphical user interface (GUI) is an indispensable 
feature of most modem computer systems. A Gul allows a 
user to interact intuitively with an application program 
running on the computer by allowing the user to manipulate 
pictorial representations of objects. Many of the display 
components of a typical GUI, such as title bars, menu bars, 
icons, multiple windows, scroll bars, pop up menus and 
dialog boxes, are now standard features. A modem GUI 
represents a major improvement over the text-based entry 
systems of just a few years ago. 

Typical dialog boxes of a GUI system allow a user to 
exchange information with an application program. Some 
dialog boxes simply require a user to confirm an operation 
before it is executed by the computer; other dialog boxes 
may ask for user selected input, such as choice of a disk 
drive, directory, file name, file type, network path, etc. 
Dialog boxes typically comprise components such as, text 
boxes, list boxes, option buttons, and command buttons. 

If a large amount of related information is to be 
exchanged between a user and the computer a GUI may 
include a special type of dialog box known as a property 
sheet system. A property sheet system, for example, can 
have a display that includes several tabs which represent 
different dialog boxes, known as a property pages. The user 
can select a tab to display the particular property page 
associated with that tab. Once selected, the user can enter 
information, confirm an operation, or make other appropri- 
ate option choices. 

Available property sheet systems can be frustrating to use. 
For example, to configure optimally an application program, 
a user often exchanges information with the program by 
using several modeless property pages. Often the configu- 
ration options that result in the desired performance of the 
application are not immediately obvious and are arrived at 
by some trial and error. Unfortunately, because the property 
sheet system displays only one property page at a time on a 
monitor, a user usually selects appropriate tabs to switch 
between multiple property pages, e.g. property pages are 
relegated to the background. Furthermore, the user is typi- 
cally required to remember the particular settings on the 
nondisplayed property pages. This procedure of continually 
switching between property pages to configure a system is 
overly laborious and time consuming. 

Accordingly, an object of the invention is to provide a 
property sheet system that allows a user to easily and 
efficiently exchange information with an application pro- 
gram. 
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A further object of the invention is to provide a property 
sheet system that reduces the need of a user to choose 
continually between displayed and nondisplayed property 
pages when the exchange of information requires the use of 
5 more than one property page. 

Other general and specific objects of the present invention 
will be apparent and evident from the accompanying draw- 
ings and the following description. 

10 SUMMARY OF THE INVENTION 

The present invention relates to, broadly, the creation of 
a second property sheet system from a first property sheet 
system. The first property sheet system includes one or more 
property pages, which are displayable on a display monitor 

15 at a first display position. The first property sheet system is 
often part of an existing application program. For example, 
a word processor program on which this application is being 
typed has a property sheet system for setting up printers. 
This property sheet system includes "tabbed" property pages 

20 entitled "setup", "paper", "destination", "print quality", and 
"fonts". According to the invention, a property page is 
selected is response to an input signal from a user-operated 
pointing and selecting device, such as a mouse. In response 
to a second signal generated by the user, typically via the 

25 mouse, the selected property page is included in, and dis- 
played by, a second property sheet system. The user may 
thus display and interact with two property pages simulta- 
neously: the selected property page, which is displayed by 
the second property sheet system, and any one of the 
property pages remaining in the first property sheet system, 
which is displayed by the first property sheet system. 

One technique by which a user may select a property sheet 
is by "tearing," that is, selecting a tab representing a property 

35 page of the first property sheet system. The property page 
"torn" or selected from the first property sheet system is 
displayed at a second location, determined by the user, on 
the display screen. Typically, a user employs "drag and 
drop" operation to select a property page, create a second 

40 property sheet system, and to display the torn property page 
at a user-selected display location. 

As noted, creating more than one property sheet system 
allows a user to view and exchange data with an application 
program using two or more property pages that are viewed 

45 simultaneously. The user need not continually switch 
between displayed and non displayed property pages, nor 
need he or she commit to memory the contents of one or 
more property pages. Note that as used herein, the term 
property page or sheet is intended to include a modal or 

50 modeless secondary window that displays user-accessible 
properties of an object. Aproperty page is said to be included 
in a property sheet system and can be displayed in a variety 
of formats to best allow a user to exchange information with 
a computer or with an application program running on a 

55 computer. 

Additionally, property pages can be exchanged between 
property sheet systems, whether these systems are created 
according to the invention or exist as part of a separate 
application program, such as a word processor program. A 

60 property page "torn" from a property sheet system is typi- 
cally displayed as a geometric object or other symbol during 
the "drag" portion of the "drag and drop" operation. A user 
can place the selected, or "torn," property page in an existing 
property sheet system for inclusion therein and display 

65 thereby, rather than in a new property sheet system created 
to include the selected page. Typically, the user places the 
symbol representing the "torn" page in close proximity to a 
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property page displayed by the property sheet system into 
which it is desired to drop the "torn" page. A docking input 
signal, such as release of a mouse button, causes the selected 
property page to "drop", or "dock" into the chosen property 
sheet system. Once docked in the chosen system, the prop- 
erty page may be used by the user just as when it was in the 
previous property sheet system. 

According to one aspect, the invention includes a proces- 
sor; a memory element; a display monitor; a user input 
device; a selection element for selecting a property page of 
a first property sheet system responsive to a signal generated 
by a user input device, such as, for example, mouse, 
trackball, or keyboard; and a second program element for 
creating a second property sheet system for including the 
selected property page and for displaying the selected prop- 
erty page at a second display position on the display monitor. 

According to another aspect, the invention includes a 
removal element for removing from the first property sheet 
system the property page selected by the selection element 
such that the selected property page is not displayable by the 
first property sheet system. 

In yet another aspect, the invention includes a destruction 
element for destroying a property sheet system when system 
does not include any property pages, such as when the last 
page in the system has been removed by the removal 
element. 

According to another aspect of the invention the invention 
further includes a docking element, for, in response to a 
signal generated by a typical user input device, placing a 
property page selected by the selection means into a selected 
property sheet system for inclusion therein and display 
thereby. 

In yet another aspect, the invention incorporates a posi- 
tioning program element, responsive to input signal gener- 
ated by the user input device, for selecting the second 
display position at which the second property sheet system 
displays property sheets included therein. 

In a different variation, the positioning element varies the 
display position of a symbol in response to a user input. The 
second program element, responsive to the user input, 
displays the selected property page at the second position. 
The positioning element also allows for placing the symbol 
in substantial registration with a displayed property page of 
a property sheet system such that the docking element, 
responsive to a user input signal, such as release of a mouse 
button, places the selected property page into the property 
sheet system with which the symbol was in substantial 
registration. The symbol can be the dotted outline of a box, 
and the box can be the approximate size of a displayed 
property page. 

To aid the user in docking a selected property page into an 
existing property sheet system, the invention can include an 
element for displaying on the display monitor an icon having 
a second display state for indicating to a user when the 
symbol or geometric object is in substantial registration with 
a property page of a property sheet system. For example, the 
icon second display state can comprise a display of a two 
puzzle pieces that are mated, and the icon can have a first 
display state comprising two puzzle pieces that are not 
mated, for indicating a when a symbol or geometric figure 
is not properly registered, i.e., the selected property page 
will not be docked by the docking means into an existing 
property sheet system. 

According to another feature of the invention, in addition 
to a positioning element responsive to user input for varying 
a position of symbol displayed on the display monitor, a a 
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proximity program element is included. The proximity ele- 
ment determines a parameter responsive to the distance on 
the display monitor between the symbol and the position on 
the display monitor of a displayed property page of a 

5 property sheet system. When the parameter is less than a first 
amount, the docking means, responsive to a first user input 
signal generated by the user input device, places the property 
page selected by the selection element into the property 
sheet system for inclusion therein and display thereby. When 

10 the parameter varies from the selected value by a second 
selected amount, the second program means, responsive to 
a second input signal, places the property page in a newly 
created property sheet system and displays the selected 
property page at a position on the display monitor substan- 

15 tially determined by the display position of the symbol. For 
example, the displayed property page can be centered about 
the position of the symbol. The first and second input signals 
can be responsive to the release of a mouse button as part of 
the "drag and drop" procedure. 

20 Of course, the invention pertains not only to a computer 
programmed in the manner described above to perform the 
transformation and operations described above, but to a 
machine readable data storage medium including the above - 
described elements. The invention is also understood to 

25 comprise methods for performing the above operations. 
It will thus be seen that certain changes may be made in 
the above constructions without departing from the scope of 
the invention. It is intended that all matter contained in the 
above and following description or shown in the accompa- 

30 nying drawings be interpreted as illustrative and not in a 
limiting sense. 

It is also to be understood that the following claims are to 
cover all generic and specific features of the invention 

35 described herein, and all statements of the scope of the 
invention which, as a matter of language, might be said to 
fall therebetween, 

BRIEF DESCRIPTION OF THE DRAWINGS 

40 The foregoing and other objects, features and aspects of 
the invention will be apparent from the following descrip- 
tion and apparent from the accompanying drawings, in 
which like reference characters refer to the same parts 
throughout the different views. The drawings illustrate prin- 

45 ciples of the invention and, although not to scale, show 
relative dimensions. 

FIG. 1 illustrates a typical computer system according to 
the invention. 

FIG. 2 illustrates a typical property page of a property 
sheet system for configuring, for example, the keyboard 
display of an application program. A user accesses each 
property page of the property sheet system by selecting the 
appropriate tab displayed at the top of the property page 

s5 window display. 

FIG. 3 illustrates an intermediate display presented as part 
of the "drag and drop" procedure for creating a new property 
sheet system including a property page "torn" from the first 
property sheet system of FIG. 2. 

60 FIG. 4 illustrates a second property sheet system includ- 
ing the property page "torn" from the first property sheet 
system illustrated in FIG. 2 and which is displayed simul- 
taneously therewith. 

FIGS. 5A and 5B depict the selected display states of a 

65 dynamic icon for aiding a user in "docking" a property page 
removed from one of the property systems for placement 
within another sheet system. 
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FIG. 6 is a flow chart diagram illustrating the steps typically by depressing a button on the mouse. During this 

involved in removing a property page from a property sheet tearing, or selection, process the user is presented with an 

system and placing it in a second property sheet system, as outline of the property page while the mouse is pressed, and 

depicted in FIGS. 2-4. tne outline can be positioned by "dragging" it anywhere on 

FIG. 7 is a schematic illustration block diagram of the 5 the display screen. FIG. 3 illustrates the outline 20 of 

software components utilized in accordance with the teach- P"**** P?^ 14 * at 1S * ^Process of being torn from its 

ings of the present invention; ^ eel s y stem * pnce the desired position is found, 

. , . . • releasing the mouse button signals the application to create 

FIG 8 illustrates the object classes, and their a new sbeet dia , and late with the 

relationships.inaccordancewiththeteachmgsofthepresent ^ torn . away property page ly^y, the original property 

invention. p a g e ^ ^ remove d from its original container, e.g., the first 

FIGS. 9A-9C illustrate parent-child relationships of par- property sheet system, and is only available in the second 

ticular object classes depicted in FIG. 8 and used in the property sheet system. The user can view and change values 

software coding according to the teachings of the invention. using different property pages in one visual context, that is, 

FIG. 10 is a hierarchical schematic illustrating the deri- 35 to view them simultaneously positioned above the desktop 

vationofkey property pages from a property page base class 13. FIG. 4 illustrates the simultaneous display of two 

according to the teachings of the present invention. property pages, the torn page 22, displayed in the display 

DESCRIPTION OF ILLUSTRATED windoW 24 ° f * e ^ «e»f«> P r0 P e # f sheet s f em ' a ° d 

EMBODIMENTS property page 14, now displayed in the original property 

20 sheet system display window 15, and corresponding to the 

The removing or tearing of property pages from a prop- tab 25 labeled "displays." The tab 18 labeled "actions" in 

erty sheet system, in accordance with the teachings of the FIG. 2 is removed from property sheet display window 15 

present invention, extends the user interface of standard and now appears in display window 24 in the newly created 

Windows/Windows 95/Windows NT property pages to property sheet system, as illustrated in FIG. 4. The property 

enable a user to change values on separate property pages 25 page 14 and the property page 22 are now displayed 

simultaneously without changing visual context. The user concurrently, and the user can exchange data with either of 

can grab the active property page and pull/tear it away from them. Typically, as the user interacts with one of the dis- 

the property sheet system and place it in an existing or newly played property pages, the other is updated, as necessary, to 

created property sheet system. However, one of ordinary . reflect the data exchange with the other. For example, if the 

skill in the art, in accordance with the teachings herein, 3Q display window 24 of the newly created property sheet 

understands the invention to be applicable to GUI's in other system is active, that is, the user is exchanging data with the 

operating environments, such as, for example, X-Windows, property page 14, the property page 22, displayed in the 

Motif, and IBM OS/2, non -active window 15 of the original property sheet system, 

The practice of the invention includes a computer, such as is updated, as necessary, to reflect the any data input by the 
the computer 2 illustrated in FIG. 1. The computer 2 35 user to the property page 14 displayed in window 24. 
typically includes input-output hardware 3, a central pro- In addition to being able to create a new property sheet 
cessor 4, random access memory 5, disk storage 6, a system for displaying the selected property page, the user 
keyboard 7, pointing device, such as a mouse 8 and a display can place the selected property page into an existing prop- 
monitor 10. The Input/output hardware 4 connects the erty sheet system. The user attaches, or docks, a "torn" 
computer 2 to, for example, a network. 40 property page into an existing property sheet system by 

FIG. 2 illustrates a typical computer display screen dis- dragging the outline 20 over the top of a property page 

play 12 of a property page 14 of a property sheet system. The displayed by that system. Releasing the mouse button when 

property page 14 in FIG. 2 is used for configuring the the outline is so positioned docks the property page into the 

keyboard display 16 of an application program that monitors property sheet system. As discussed immediately above, a 

and controls industrial processes. One such industrial pro- 45 displayed property page in a non active window is updated, 

cess control system is the I/A SERIES® System available as necessary, to reflect any input by a user to a displayed 

from The Foxboro Company, of Foxboro, Mass., USA. property page in an active window. Using the docking 

However, an industrial process monitoring system is merely procedure, the property page 14 in FIG. 4 can be selected 

one example of the type of environment in which property and placed back into in the original property sheet system for 

pages are typically very useful; the present invention is 50 re-display in display window 15. 

useful in many computer application programs, such as A visual cue, such as a dynamic icon 28 in FIGS. 5 A and 

word processors, spreadsheets, communications packages, 5B, is provided to assist in the tear-away/docking operation, 

web browsers, etc. However, in the particular embodiment During the dragging process, the user is provided with a 

illustrated here, the property pages are used to configure a symbol such as dynamic icon 28 that shows two puzzle 

keypad annunciator of an industrial process control system, 55 pieces. When the drag box is over a dock-site, i.e., over an 

such as the keypad annunciator 16 in FIG. 2. Many of the existing property sheet system that can accept the property 

keys of a keypad annunciator 16 are configurable, via page being dragged, the puzzle pieces join and appear as a 

property pages, such that a given individual key is associated second display state 32, thus signifying to the user that the 

with a particular alarm state of the industrial process control dragged page can be docked e.g., accepted, into the that 

system; occurrence of that alarm state causes the key to 60 system. FIG. 5 A illustrates the dynamic icon in the first 

change appearance. The key is also configurable such that display state 30 wherein the puzzle pieces are separated, 

selecting the key with the mouse can initiate selected indicating that the drag box or geometric shape 20 is not 

corrective action or display a selected process graphic. properly positioned for a property page to be docked. 

To "tear" a page from a property sheet system, the user The invention uses the logic depicted in the operational 

positions a cursor over the body (i.e., generally anywhere 65 flow chart illustrated in FIG. 6. Starting at decision box 34, 

other than an edit field or the tab representing the property pressing a mouse key when the cursor is within a property 

page 14) of property page 14 and provides an input signal, page "tears" the property page and leads along the "yes" 
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branch of box 34 to box 36. As the mouse is dragged, that . such as MFC library, are not described, or if described, are 

is, moved with the mouse button pressed, an outline of the only briefly discussed. 

property page is drawn on the screen. This process will yhe present invention provides for a sophisticated prop- 
continue until the user releases the mouse button. Releasing erty sneet S y S t em that supports modeless operation and 
the mouse button leads from along the "yes" branch of box 5 tear . away property pages. The system uses the standard 
36 to decision box 38, which determines whether the torn , em software components illustrated in FIG. 7. The 
property page can be docked, thai is, whether the drag box components inc i ude the application frame window 46 and 
20 is positioned over a property page of an existmg property me sheet 4g Jn al> shee , 
sheet system. If docking is possible the torn page is docked ms afe ^ lemented ming three components: a prop- 
into the "target" system, as in box 42; if the page cannot be 10 frame ^ a shee , 48B> and one Qf ma 
docked, a new property sheet system is created for inclusion ^ ltee three eompooattB 48A-ASC are 
of the torn property page, as indicated by box 40. Finally, m related ^ , are the children of the 
box 44, the torn page is removed from the original property sheet m ^ sheet ^ ^ me child of the 
sheet system, and if no other pages remain in the original, or frame ^ and , n6 ^ fc owned b 
source, property sheet system the system is deleted, or 15 the application . s main frame window 46 . Because the prop- 
destroyed. In the remainder of the specification the object frame ^ js typicMy a top . level ^ndow, it generally 
classes and coding to perform the above-described opera- cannot be a child of anQther window> but it can be owned . 

ions are . ^ e _ resent invention extends the standard property sheet 

The present invention uses techniques of object-oriented such ffi ^ fa Ha ? fa ex t endi n g the standard 

programming. In object-onented programming routines are 20 tQ a „ ow ^ ^ of ^ creation of 

separate entities that include both data and functions, or n£w sheet and ^ dockin Qf tofn 

methods for processing the data. Object-onented program- £ ^ exjsti sheet s The dasses 

ming differs from traditional structured programming, which ' jjjugtrated in FIG 8 

relied heavily on subroutines, and in which data and the m ,. _ . , , ■ „ , , , , 

routines that handled the data were usually strictly segre- 25 ^ ^JP hca ^ frame wl ° dow class 50 labeled CACR- 
gated. Structural programming is organized in terms of Frame Wndm FIG. 8, provides management support for the 
computer details, such as files, record, and sorting algo- P"**** shee * s y stem 55 ' The application frame window 
rithms; object oriented programming is organized in terms class 5 ° P rov u lde * P r0 P ert 5 ^ dock s »PP ort > P r0 P ert y ^ 
of the physical entities, the "objects, » that exist in the pliability hand hng, and property sheet system creation, 
environment in which the problem is to be solved. The data 30 ™ e a PP hcatl( f c frame 50 constructs the property 
and methods stored in a object represent, respectively, the sheet s y stem 55 ™ th a creation mask that indicates which 
attributes of the physical object and the actions a object is P ro P ert y PfS es J 6 to c ; eate ; Additionally, the application 
capable of carrying out. Objects are related to classes; an frame window 50 provides the notification interface used by 
object is said to be an instance of a class. A class is not an th ^ property sheet system 55 when property or selection 
object, but a template that instructs a compiler how to 35 mformatlon has chan S ed m a P ro P ert y P a S e 36 ' 
construct an actual object. property sheet system 55 is comprised of three 
Those of ordinary skill in the art of modem programming distinct P arts ■ first and least significant of these corn- 
are familiar with object-oriented concepts such as P onents 1S the .sheet frame class 52. The s property 
encapsulation, inheritance and polymorphism. Encapsula- sheet frame 52 * a mini-frame window that is used to house 
tion refers to combining data and functions, or methods, that 40 the P ro P ert y sheet system 55 window. The property sheet 
process the data into a single object, wherein the internal frame 52 al [ ows the P;°P ert y ^ s yf em . 55 window and 
details of the methods and data may be largely hidden. pages 56 to be operated m an modeless f^hion^e property 
Inheritance refers to a derived class inheriting the features sheet frame 52 creates . the P ro P ert y sheet 54, hides itself 
and capabilities of the base, or parent, class. The derived when clos f d > and P r0Vldes access methods t0 lts owned 
class can then be modified to suit a particular need. Poly- 45 P ro P ert y sneet 54. 

morphism allows objects whose properties differ to be able The property sheet class 54 provides management support 
to function together. That is, the interfaces through which for the key property pages 56. This support includes prop- 
objects exchange messages are standardized and not depen- erty page creation, property page docking support, and 
dent on the exact internal working of an object. Because of property page update facilities. 

encapsulation, polymorphism and inheritance, object 50 The individual property pages 56 constitute the final 
oriented-programming is a modular approach that reduces component of the property sheet system 55. Each property 
the amount of coding a designer of a new system or function page 56 provides specific edit functions for a portion of the 
needs to perform. Objects can be joined in a coherent data exchanged with an application program. Each property 
procedure in which objects can be added, modified or page is derived from a base property page that provides 
deleted without a designer having to rewrite a whole appli- 55 application-specific property page functions. The base prop- 
cation. A considerable amount of code written by others is erty page provides tear-away page support, and facilities to 
reusable, and is often reused. For example, the Microsoft update a keyboard or be updated from a keyboard. The base 
Foundation Class (MFC) Library is a set of more than 100 property page also provides an iterative mechanism for 
classes designed to help C++ programmers write Windows- setting property information for multiple keys of keypad 
based programs. The present invention built upon classes 60 annunciator 16 in FIG. 2 to facilitate disabling of controls, 
from the MFC version 4.1 library. Further elaboration is provided below, in a separate see- 
Accordingly, described herein are only those class tion on each of the components. Class definitions and a 
definitions, and code segments, necessary for one of ordi- description of the instance variables and methods for the 
nary skill in the relevant programming arts, possessed of all property frame class, property sheet class, and property page 
the teachings herein, to make and use the invention. Classes, 65 classes are provided. Important code sections for the prop- 
objects and codes well known to, or easily created by, those erty sheet and property page classes are listed at the end of 
of ordinary skill in the art, or available in published libraries, the specification, and additional code, including code per- 
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taining to modification of the application frame window 
class is provided in an appendix. Coding for the property 
sheet frame class is not provided. 

Application Frame Window Class 

Coding for portions of the application frame window class 
is provided in the appendix. 

Property Sheet Frame Class — 
CPropertySheetFrame: CMiniFrameWnd 

The property sheet frame 52 allows the property sheet 
system window and pages to be operated in a modeless 
fashion. The property sheet frame 52 can operate to create 
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Methods 

CPropertySheetFrame(UINT wCreatePageMask): 



This 



method is the constructor for the CPropertySheetFrame 
class. The constructor will store the specified page creation 
5 mask internally and use it later during the creation process. 
The constructor will initialize the m_pACRPropertySheet 
member variable to NULL. 

-CPropertySheetFrameQ: This method is the destructor 
for the CPropertySheetFrame class. The destructor will 
io destroy the m_ J ACRPropertySheet member variable, 

GetPropertySheet(): This method returns the 
m^ACRPropertySheet pointer. 

OnCreate(LPCREATESTRUCT lpCreateStruct): This 
method handles the creation of the frame window. This class 



the property sheet, to hide itself when closed, and provides is customizes the creation process by creating the property 



access methods to its owned property sheet. 

As shown in FIG. 8 and in FIG. 9A, the CPropertySheet- 
Frame 52 provides the harness window for the property 
sheet system. The CPropertySheetFrame 52 creates, 
destroys, manages visibility, and facilities modeless opera- 
tion of the property sheet system. 

The CPropertySheetFrame class 52 is defined below in 
Tables 1 and 2. 



sheet system at this time. The property sheet system is 
created with the page create mask, m_wCreatePageMask, 
that was specified during class creation. 

OnClose(): This is a method that intercepts the normal 
20 window close behavior. The default behavior of the close 
process is to destroy the window and this class. This method 
simply hides the window. The destruction of this class is the 
responsibility of the CACRFrameWindow. 



TABLE 1 



Name 



CPropertySheetFrame Class Definition 



Parameters 



Returns 



Virtua 



Access 1 



CPropertySheetFram 
e 

CPropertySheetFram 
e 

GetPropertySheet 
On Create 
OnClose 
OnSetFocus 
On Activate 



UINT 

wCReatePageMask 
void 



void 



Nothing 
Nothing 



CACRP roper ty She 
et* 

LPCREATESTRUCT int 
lpCreateStruct 



void 

CWnd* pOldWnd 

UINT nState, 
CWnd* pWndOther, 
BOOL bMinimized 



void 
void 
void 



public no 
public yes 

public no 

protect no 
ed 

protect no 
ed 

protect no 
ed 

protect no 
ed 



TABLE 2 


CPropertySheetFrame Data Definition 




Name 


Type 


Access 


m_pACRrope rtySheet 


CACRPropertySheet* 


private 


m_wCreatePageMask 


UINT 


private 



Below is a description of the data and methods of the 
CPropertySheetFrame 52. 



Data 

m_pACRPropertySheet: This data member is a pointer to 
the property sheet system that is created and managed by this 
frame. 

m_jwCreatePageMask: This a data member s the initial 
page creation mask used to define this property sheet system. 
The page creation mask is a bit field that indicates to the 
property sheet system which property pages to create. 



OnSetFocus(CWnd* pOldWnd): This is a method that 
forwards the focus handling to the embedded property sheet 
system if one is defined. 

OnActivate(UINT nState, CWnd* pWndOther, BOOL 
bMinimized): This is a method that forwards the activation 
handling to the embedded property sheet system if one is 
defined. 



Property Sheet Class — 
CACRPropertySheet: CPropertySheet 

60 

The CACRPropertySheet 54, illustrated in FIGS. 8 and 
9B, provides support for the key property pages. CACR- 
PropertySheet customizes the default property sheet behav- 
ior by providing automatic property page creation, property 
65 page docking support, and property page update facilities. 
The CACRPropertySheet class 54 is defined below in Tables 
3 and 4. 
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TABLE 3 

CACRPropertvSheet Class Definition 

Virtua 



Name 


Parameters 


Returns 


Access 


1 


CACRPropertySheet 


CWnd* pWndParent, 


Nothing 


public 


no 




UINT 










wPageCreateFlag 








-CACRPropertySheet 


void 


Nothing 


public 


yes 


OnCreate 


LPCREATSTRUCT 


int 


protecte 


no 




lPCreateStruct 




d 




CreatPage 


UINT wPageMask 


void 


public 


no 


PostNeDestroy 


void 


void 


public 


no 


DestroyPage 


UINT wPageMask 


void 


public 


no 


IsPageEnabled 


UINT wPageMask 


BOOL 


public 


no 


GetPagcMask 


void 


UINT 


public 


no 


FindPage 


UINT wPAgeMask 


CPropertyPage* 


public 


no 


TearOffPage 


UINT wPageMask, 


void 


public 


no 




LRECT 










pTearOffRect 








UpdatePageControl 


void 


void 


public 


no 



TABLE 4 



CACRPropertvSheet Type Definitions 



Mask 


Value 


NO PAGES 


0x00000000 


PAGES_ACTIONS 


0x00000001 


PAGE_DISPLAYS 


0x00000002 


PAGE_PROGRAMS 


0x00000004 


PAGE_COMMANDS 


0x00000008 


PAGE_j\LARM_LIST 


0x00000010 


PAGE _ALARM_COLO 


0x00000020 


R 

LEGAL_PAGES_ONL 


0x0000003f 


Y 

ALL_AVAILABLE_PA 


Oxfiffifff 


GES 





Masks 

The following masks are used to define property pages 
that are used in the CACRProperySheet implementation. 

NO_PAGES: Specifies no pages. 

PAGE_ACTIONS: Specifies the Alarm Actions Property 
Page. 

PAGES__DISPLAYS: Specifies the Display Property 
Page. 

PAGE_PROGRAMS: Specifies the Program Property 
Page. 

PAGE_COMMANDS: Specifies the Command Property 
Page. 

PAGE_ALARfvLLIST: Specifies the Alarm List Prop- 
erty Page. 

PAGE_ALARM_COLOR: Specifies the Color Property 
Page. 

LEGAL__PAGES_ONLY: Specifies all the legal Property 
Pages. 

ALL_AVAILABLE_PAGES: Specifies all pages, legal 
or otherwise. 

Methods 

CACRPropertySheet(CWnd* pWndParent, UINT 
wPageCreateFlag): This is the constructor for the property 
sheet system. The constructor will invoke the Create Page 
member with the specified page create mask. 



-CACRPropertySheetO This is the destructor for CACR- 
PropertySheet. The destructor will delete all ed property 
25 pages. 

OnCreate(LPCREATESTRUCT lpCreateStruct): The 
OnCreate handler automatically snaps this window to the 
client region of its parent, typically the CPropertySheet- 
Frame. 

30 PostNeDestroy 0: This method calls the default Post- 
NeDestroy handler and then deletes itself. 

CreatePage(UINT wPageMask): This method will creates 
the property pages specified by the page mask. All created 
property pages are automatically added to this property 

35 sheet. 

DestroyPage(UINT wPageMask): This method will find 
the page with the specified mask, remove it from the 
property sheet system, and destroy it. The page mask must 

4Q specify a single page for this method. 

IsPageEnabled(UINT wPageMask): This method will 
determine it the page specified by the page mask is present 
in this property sheet system. This method will return TRUE 
if the page is found, FALSE otherwise. 

45 GetPageMask(void): This method will return the page 
mask for all the pages ed in this property sheet system. 

FindPage(JINT wPageMask): This method will find the 
page specified by the page mask. This method will return the 
specified page if it is found, NULL otherwise. 

50 TearOffPage(UINT wPageMask): This method will 
request the main frame window to create a property sheet 
system in the specified page mask, remove the specified 
page from the property sheet system, and if the property 
page removed is the last on kill this class. 

55 UpdatePageControl(void): This method provides a work 
around to a MFC 3.0 bug concerning the automatic redraw 
of the page control used in the property sheet system. 

Property Page — CACRPropertyPage: 
60 CPropertyPage 

The CACRPropertyPage 56, as illustrated in FIGS. 8 and 
9C, provides the core behavior for the key property sheet 
system for the process control application program. The key 
property sheet system is used to configure the keys, of the 
65 keypad annunciator 16 in FIG. 2. CACRPropertyPage 56 
provides tear-away page support and facilitates setting of 
properties from and to a target data source. 
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The CACRPropertyPage class is defined below in Tables 
5 and 6. 

TABLE 5 



CACRPropertyPage Class Definition 



Name 


Parameters 


Returns 


Access 


Virtu 
al 


C ACRP rope r ty Pa ge 


UINT wPagelD, 


Nothing 


public 


no 




UINT nIDTemplate, 










UINT nIDCaption 










T PP9TTR 


Nothing 


public 


no 




lpszTemplateName, 










UINT nIDCaption 








-CACRPropertyPage 


void 


Nothing 


public 


yes 


GetPagelD 


void 


UINT 


public 


no 


BeginPropertySet 


void 


void 


public 


yes 


EndPropertySet 


void 


void 


public 


yes 


GetPropertySheet 


void 


CACRProper 


public 


no 






tySheet 






ClipRectToWindow 


HWND hWnd, 


void 


protecte 


no 




LPRECT pRECT 




d 




Track 


HDC hDQ 


void 


protecte 


no 




LPRECT pTrackRect, 




d 






BOOL bKillTrack 








TearOffDialog 


LPRECT pTearOffRect 


void 


protecte 
d 


no 


OnLButtonDown 


UINT nFlags, CPoint 


void 


protecte 


no 




point 




d 




OnLButtonUp 


UINT nFlags, CPoint 


void 


protecte 


no 




point 




d 




OnMouseMove 


UINT nFlags, CPoint 


void 


protecte 


no 




point 




d 





TABLE 6 

CACRPropertyPage Data Definition 



Name Type Access 



m rTrackRect 


RECT 


protected 


m_blsTracking 


BOOL 


protected 


m_blsTearable 


BOOL 


protected 


m_bDitherLast 


BOOL 


protected 


m_sizeLast 


SIZE 


protected 


m_rectLast 


RECT 


protected 


m_ptStartPoint 


POINT 


protected 


m_wPagc£D 


UINT 


protected 



45 



Data 

m_rTrackRect: This variable s the property page tracking 
rectangle during a page tear operation. 

m_bIsTracking: This variable indicates that the property 50 
page is in the process of being torn off. 

m_bIsTearable: This variable indicates that the current 
property page is te arable. 

m__bDitherLast: This variable indicates the state of the 55 
last drag track render operation. To maximize visibility the 
track rectangle is rendered in a combination of dithered 
states and non-dithered states. 

m_sizeLast: This variable s the size of the last track 
render operation. 60 

m_rectLast: This variable s the rectangle that was pre- 
viously rendered during the drag operation. 

m_dtStartPoint: This variable s the starting point of the 
drag operation. The start point will maintain the relative 
position of the drag rectangle to the mouse. 65 

m_wPageID: This variable s the page id of this property 
page. The page id is defined on creation of the property page. 



Methods 

CACRPropertyPage(UINT wPageID,UINT 
nIDTemplate,UINT nIDCaption): This is the constructor for 
the CACRPropertyPage dialog. The constructor requires 
specification of the page ID, a dialog template, and a 
caption. 

CACRPropertyPage(UINT wPagelD ,LPCSTR 
lpszTemplateName,UINT nIDCaption): This is a construc- 
tor for the CACRPropertyPage dialog. This version of the 
constructor allows for the specification of the template using 
a string. 

~CACRPropertyPage(): This is the destructor for the 
CACRPropertyPage class. 

GetPageID(void): This method returns the m_PageID 
member variable. 

BeginPropertySet(void): This method provides a hook for 
derived property page classes to initialize data state infor- 
mation to properly reflect data values under multiple keys. 

EndPropertySet(void): This method provides a hook for 
derived property pages to end the property setting process by 
reflecting collected state information into the property page 
controls. 

GetPropertySheet(void): This method returns the parent 
property sheet. This method will ASSERT if the parent 
property sheet is not of CACRPropertySheet style. 

CiipRectToWindow(HWND hWnd,LPRECT pRect): 
This method will clip the specified rectangle to the specified 
window. The method will maintain the size of the specified 
rectangle if possible. 

Track(HDC hDC, LPRECT pTrackRect, BOOL 
bKillTrack=FALSE): This method performs tracking for the 
property page drag/tear operation. 

TearOffDialog(LPRECT pTearOffRect): This method 
performs the property page tear operation. It determines it 
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the specified rectangle represents a tearable state and if so 
performs the tear operation. 

OnLButtonDown(UINT nFlags, CPoint point): This 
method handles the left mouse button down processing. This 
method will start the property page tear operation. 

OnLButtonUp(UINT nFlags, CPoint point): This method 
handles the left mouse button up processing. This method 
will end the property page tear operation. 

OnMouseMove(UINT nFlags, CPoint point): This 
method handles mouse move processing. This method will 
drag the page tear rectangle if the mouse button is pressed 
and the page tear operation is underway. 

Key Prolerty Pages 

In the application described here, wherein the property 
pages are used to exchange information about, and to 
configure, the keys of keypad annunciator 16 in FIG. 2, the 
key property pages are derived from the CACRPropertyPage 
base class, as shown in FIG. 10. The property pages provide 
specific edit operations for the key data. 

Each property page will be implemented in a similar 
fashion. In general, each property page will provide the 
following interface, as set forth in Table 7. 

TABLE 7 

CACRGenericEditPage Class Definition 

Virtu 



Name 


Parameters 


Returns 


Access 


al 


CACRGenericEditPage 


UINT wPagelD, 


Nothing 


public 


no 




UINT nIDTemplate, 










UINT nlDCaption 








CACRGenericEditPage 


LPCSTR 


Nothing 


public 


no 




IpszTemp lateNa me, 










UINT nlDCaption 










void 


Nothing 


public 


yes 


CACRGenericEditPage 










BeginPropertySet 


void 


void 


public 


yes 


EndPiopertySet 


void 


void 


public 


yes 



Code sections for the property sheet and property page 
classes, as well as code sections pertaining to modification 
of the application frame window class, are provided in an 
appendix. The code is written in the C++ programming 
language, but can be used as the operational foundation for 
other implementations. 

I claim: 

1. A computerized data processing apparatus, comprising 
processor means for executing a program, 

a memory element for storing the program, 
a display monitor for providing a display, 
selection means for selecting a property page of a first 
property sheet system, the first property sheet system 
including at least one property page displayable at a 
first position on the display monitor, and 
creation means for creating a second property sheet 
system including said selected property page, said 
selected property page being displayable at a second 
display position on the display monitor. 

2. The data processing apparatus of claim 1 further 
including 

removal means for removing said property page selected 
by said selection means from said first property sheet 
system such that said selected property page is not 
displayable by said first property sheet system. 

3. The data processing apparatus of claim 2 further 
including 
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destruction means for destroying said first property sheet 
system when said first property sheet system does not 
include any property pages. 

4. The data processing apparatus of claim 1 further 
comprising 

positioning means for varying and indicating on the 
display monitor said second display position at which 
said property page selected by said selection means and 
included in said second property sheet system is dis- 
playable by said second property sheet system. 

5. The data processing apparatus of claim 1 further 
including 

docking means for placing said property page selected by 
said selection means into a selected property sheet 
system for inclusion therein, said property page being 
displayable on the display monitor by said selected 
property sheet system. 

6. The data processing apparatus of claim 5 further 
comprising 

positioning means for varying and indicating the position 
on the display monitor of a symbol representative of a 
property page selected by said selection means, and 

proximity means for determining a parameter responsive 
to the distance on the display monitor between said 
symbol and the position on the display monitor of a 
displayed property page of a property sheet system, and 
wherein when said parameter is less than a first selected 
value, said docking means in response to a first user 
input places said selected property page in said prop- 
erty sheet system displaying said displayed property 
page for inclusion therein and for display on the display 
monitor thereby. 

7. The data processing apparatus of claim 6 wherein when 
said parameter is greater than a second selected value, said 
creation means in response to a second user input displays 
said selected property page included in said second property 
sheet system at a position on the display monitor determined 
by the display position of said symbol. 

8. The data processing apparatus of claim 7 further 
comprising 

a pointing and selecting user input means including a 
user-depressable key for providing user input to said 
docking and creation means, said first and second user 
inputs being provided to said docking and creation 
means by depression of said key. 

9. The data processing apparatus of claim 6 further 
comprising 

icon means for displaying on the display monitor an icon 
having at least a first display state, said icon being 
displayed in said first display state when said parameter 
is less than said first selected value, said first display 
state indicating to a user that said docking means, in 
response to said first user input, places said selected 
property page into said property sheet system display- 
ing said displayed property page, 

10. The data processing apparatus of claim 9 wherein said 
icon means further comprises means for displaying said icon 
in a second display state when said parameter is greater than 
a second selected amount, said second display state indicat- 
ing to a user that said second property sheet system displays 
said property page selected by said selection means at a 
position on the display monitor determined by the position 
of said symbol. 

11. A machine readable data storage medium comprising 
means for selecting a property page, displayable at a first 

display position on a display monitor, of a first property 
sheet system, and 
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means for creating a second property sheet system includ- 
ing said selected property page, said selected property 
page being displayable on a display monitor at a second 
display position on the display monitor. 

12. A machine readable data storage medium according to 
claim 11 including 

means for removing said selected property page said first 
property sheet system such that said selected property 
page is not displayable by said first property sheet 
system. 

13. A machine readable data storage medium according to 
claim 12 including 

means for destroying said first property sheet system 
when said first property sheet system does not include 
any property pages. 

14. A machine readable data storage medium according to 
claim 11 comprising 

means for varying and indicating on the display monitor 
said second display position at which said property 
page selected by said selection means and included in 
said second property sheet system is displayable by 
said second property sheet system. 

15. A machine readable data storage medium according to 
claim 11 comprising 

means for docking said property page selected by said 
selection means into a selected property sheet system 
for inclusion therein, said property page being display- 
able on the display monitor by said selected property 
sheet system. 

16. A machine readable data storage medium according to 
claim 15 comprising 

means for varying and indicating the position on the 
display monitor of a symbol representative of a prop- 
erty page selected by said selection means, and, 

means for determining a parameter responsive to the 
distance on the display monitor between said symbol 
and the position on the display monitor of a displayed 
property page of a property sheet system, and wherein 
when said parameter is less than a first selected value, 
said means for docking, in response to a first user input, 
places said selected property page in said property 
sheet system displaying said displayed property page 
for inclusion therein and for display on the display 
monitor thereby. 

17. A machine readable data storage medium according to 
claim 16 wherein when said parameter is greater than a 
second selected value, said means for creating, in response 
to a second user input, displays said selected property page 
included in said second property sheet system at a position 
on the display monitor determined by the display position of 
said symbol 

18. A machine readable data storage medium according to 
claim 17 comprising 

means responsive to a pointing and selecting user input 
device, wherein said device includes a user-depressable 
key for providing user input to said means for docking 
and to said means for creating, said responsive means, 
upon depression of said key, providing first and second 
user inputs to said means for docking and to said means 
for creating. 

19. A machine readable data storage medium according to 
claim 16 comprising 

means for displaying on the display monitor an icon 
having at least a first display state, said icon being 
displayed in said first display state when said parameter 
is less than said first selected value, said first display 
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state indicating to a user that said means for docking, 
in response to said first user input, places said selected 
property page into said property sheet system display- 
ing said displayed property page. 

20. A machine readable data storage medium according to 
claim 19 wherein said means for displaying an icon further 
comprises means for displaying said icon in a second display 
state when said parameter is greater than a second selected 
amount, said second display state indicating to a user that 
said second property sheet system displays said property 
page selected by said means for selecting at a position on the 
display monitor determined by the position of said symbol. 

21. A computerized method for displaying property pages 
on a display monitor, comprising the steps of 

creating a first property sheet system including at least 
one property page displayable at a first position on a 
display monitor, 

selecting a property page of said first property sheet 
system, and 

creating a second property sheet system including said 
selected property page, said selected property page 
being displayable at a second display position on the 
display monitor. 

22. The method of claim 21, further comprising the step 
of removing said selected property page from said first 
property sheet system such that said selected property page 
is not displayable by said first property sheet system, 

23. The method of claim 22, further comprising the step 
of destroying said first property sheet system when said first 
property sheet system does not include any property pages. 

24. The method of claim 21, further comprising the step 
of displaying said second display position on the display 
monitor. 

25. The method of claim 24, further comprising the step 
of displaying said selected property page by said second 
property sheet system. 

26. The method of claim 21, further comprising the step 
of placing said selected property page into a selected prop- 
erty sheet system for inclusion therein, said property page 
being displayable on the display monitor by said selected 
property sheet system. 

27. The method of claim 26, further comprising the steps 

of 

indicating the position on the display monitor of a symbol 
representative of a property page, and 

determining a parameter responsive to the distance on the 
display monitor between said symbol and the position 
on the display monitor of a displayed property page of 
a property sheet system, 

wherein when said parameter is less than a first selected 
value, said placing step disposes said selected property 
page in said property sheet system displaying said 
displayed property page for inclusion therein for dis- 
play on the display monitor, in response to a first user 
input. 

28. The method of claim 27, further comprising the step 
of determining when said parameter is greater than a second 
selected value, wherein said creating step in response to a 
second user input displays said selected property page 
included in said second property sheet system at a position 
on the display monitor determined by the display position of 
said symbol. 

29. The method of claim 28, further comprising the step 
of providing user input by depression of a user-depressable 
key. 

30. The method of claim 27, further comprising the step 

of 
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displaying on the display monitor an icon having at least 
a first display state, said icon being displayed in said 
first display state when said parameter is less than said 
first selected value, said first display state indicating to 
a user that said placing step, in response to said first 
user input, places said selected property page into said 
property sheet system displaying said displayed prop- 
erty page. 

31. The method of claim 30, further comprising the step 
of displaying said icon in a second display state when said 
parameter is greater than a second selected amount, said 
second display state indicating to a user that said second 
property sheet system displays said property page selected 
by said selection means at a position on the display monitor 
determined by the position of said symbol. 

32. A computerized data processing apparatus, compris- 
ing 

a processor for executing a program, 
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a memory element for storing the program, 
a display monitor for providing a display, 
a selection module for selecting a property page of a first 
5 property sheet system, the first property sheet system 
including at least one property page displayable at a 
first position on the display monitor, and 
a creation module for creating a second property sheet 
system including said selected property page, said 
selected property page being displayable at a second 
display position on the display monitor. 
33. The data processing apparatus of claim 1, further 
comprising destruction means for destroying said first prop- 
is erty sheet system when said first property sheet system does 
not include any property pages. 

***** 
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